TED External Transfer

A TED transfer is very similar to a Pix transfer with bank account details, but it uses a different system and will only be processed on business days until 17:00 BRT time

Request

URL

POST 'https://apisandbox.delbank.com.br/baas/api/v2/transfers

cURL

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transfers' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-delbank-api-key: PJPyJ2xGmyB9oDHyNIUwNOt1dgpgolBwcE16ybaKD5rYEc8ujLtarBP0nNw2FKdgK+5YJFciFwTdORlZsdaTzjEbKN5ut+Ag4xGy69bbtXJmzkzRDHry9ubYbMW4xFMb' \
--header 'IdempotencyKey: ea2e597a-3f5f-4788-91ac-4c3b4689a868' \
--data '{
  "amount": 0.01,
  "description": "test",
  "type": "External",
  "beneficiary": {
    "participantIspb": "18236120",
    "branch": "0001",
    "holder": {
      "document": "30030030030",
      "email": "[email protected]",
      "name": "Carlos Luis"
    },
    "number": "210001953",
    "type": "CURRENT"
  }
}'

Headers

Name	Description
x-delbank-api-key	Required. API key
IdempotencyKey	Required. Request's idempotency key. Provide a GUID, being a new one for each request..

Body

Name	Type	Description
amount	number	Required. Transfer amount.
description	string	Description about the transfer, internal use only
type	enum	Required. For TED transfer this value should always be External
beneficiary	object	Required. Object containing information on the transaction beneficiary
participantIspb	string	Required. ISPB code of the beneficiary client bank account.
branch	string	Required. Beneficiary account branch
number	string	Required. The account number
type	enum	Required.Beneficiary client bank account type.. Domains: CURRENT - Current Account PAYMENT - Payment Account SAVING - Savings Account SALARY - Salary Account
holder	object	Required. Object containing information about the beneficiary account holder
document	string	Required. Beneficiary account holder CPF or CNPJ
email	string	Required. Beneficiary account holder e-mail
name	string	Required. Beneficiary account holder full name

Response

The status code 200 will indicate success in the transaction.

Being successful, the return will bring the following fields in JSON format:

Note

🚧 This information will be returned after the transfer creation and transfer query.

{
    "id": "{id}",
    "status": "DONE",
    "type": "TED",
    "amount": 0.01,
    "createdAt": "2025-02-10T12:48:20.695Z",
    "description": "Test",
    "payer": {
        "number": "{payer_account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    },
    "beneficiary": {
        "number": "{account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    }
}